home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1997 February / EnigmA AMIGA RUN 15 (1997)(G.R. Edizioni)(IT)[!][issue 1997-02][PLANET CD V].iso / progs / sviluppo / python-1.4 / readme < prev    next >
Text File  |  1997-01-12  |  6KB  |  189 lines
  1.  
  2.  
  3.                            PYTHON 1.4 RELEASE 1
  4.                           NOTES ON THE AMIGA PORT
  5.  
  6.                              January 12, 1997.
  7.  
  8.     
  9.            Conversion and Amiga specific code by Irmen de Jong.
  10.               (Original code by Guido van Rossum and others)
  11.  
  12.  
  13.  
  14.                    Read the file <DISCL_and_COPYRIGHT>!
  15.  
  16.    It contains the disclaimer for this software, and copyright notices.
  17.  
  18.  
  19.  
  20.     Contents:
  21.     ~~~~~~~~~
  22.  
  23.     1. What's new?    
  24.     2. General remarks.
  25.     3. Troubleshooting.
  26.     4. Future.
  27.     5. Modification history.
  28.  
  29.  
  30. +----------------------+
  31. |                      |
  32. |  1. What's new?      |
  33. |                      |
  34. +----------------------+
  35.  
  36. IMPORTANT CHANGES SINCE THE PREVIOUS VERSION (version 1.3 Jun 26 1996):
  37.  
  38.     - PYTHON IS NOW VERSION 1.4! (which is about 30% faster than 1.3)
  39.       See Python's home page for information on what's new.
  40.     - AREXX SUPPORT: arexx module!
  41.     - MORE AMIGADOS SUPPORT: doslib module!
  42.     - More & better docs for Amiga features!
  43.  
  44.   Fixed bugs:
  45.     - amigamodule: getcwd now returns the CORRECT current directory
  46.     - amigamodule: listdir now gives accurate error descriptions
  47.     - mathmodule: fmod fixed for IEEE math
  48.   Other changes:
  49.     - python now accepts Workbench icon tooltypes, arguments and scripts.
  50.     - some changes to the test set (extensions)
  51.     - included some new icons
  52.     - module search path treatment has been changed (conform 1.4 behavior)
  53.       See docs/Amiga/general.
  54.     - syslog module: logs are now prefixed by program name "Python"
  55.  
  56.  
  57. +----------------------+
  58. |                      |
  59. |  2. General remarks  |
  60. |                      |
  61. +----------------------+
  62.  
  63. * All tests in Lib/test ran successfully with my version.
  64.   To try it yourself, type (after installation):
  65.   cd Python:lib/test
  66.   //Python -c "import autotest"  (and have patience...)
  67.   //Python -c "import autotest"  (and have patience...)
  68.   (Yes: do it TWICE because the generated .pyc files need to be checked too).
  69.   Both runs should report 'all tests OK'.
  70.  
  71. * To  see  some  command  line  options,  use  the -?  option, or any other
  72.   unrecognised option.
  73.  
  74. * The  `Docs'  directory  contains  2 text files regarding regular expression
  75.   syntax,  and  some  other  documents.   You might want to copy other python
  76.   documentation in here.
  77.  
  78. * In the `Docs/Amiga' directory you can find the docs for the Amiga specific
  79.   modules and features. Read them, they contain vital information!
  80.  
  81. * In the `Icons' directory there are some icon suggestions.
  82.   def_py.info is an icon for Python source files (.py)
  83.   def_pyc.info is an icon for Pytnon bytecode files (.pyc)
  84.  
  85. * The following modules are built-in in this release:
  86.     amiga        arexxll        array        binascii
  87.     cmath        crypt        doslib        environment
  88.     errno        grp        imp        marshal
  89.     math        md5        new        operator
  90.     pwd        regex        rotor        select
  91.     socket        soundex        strop        struct
  92.     sys        syslog        time        timing
  93.     urlop
  94.  
  95.   Amiga specific: amiga, arexxll, doslib, environment
  96.   Needs usergroup.library: crypt, grp, pwd.
  97.   Needs AmiTCP's bsdsocket.library: select, socket, syslog.
  98.  
  99. * Mail  me  if  you encounter any Amiga specific problems, or if you have any
  100.   Amiga  related  questions  about  Python,  or  just  for fun.  General
  101.   questions are better asked on the usenet newsgroup comp.lang.python.  A lot
  102.   of   information,   including  an  online  manual,  can  be  obtained  from
  103.   <http://www.python.org/>,  or  <http://www.cwi.nl/www.python.org/>  if  your
  104.   site is close to the Netherlands.  Read the FAQ before asking!
  105.  
  106. * Version 1.3 is no longer supported by me. Please upgrade to 1.4.
  107.  
  108.  
  109. +-----------------------+
  110. |                       |
  111. |  3. Troubleshooting   |
  112. |                       |
  113. +-----------------------+
  114.  
  115. * When  I  try  to  install  Python,  I  get  "Unable  to  open  your tool
  116.   'installer'"!
  117.  
  118.   The Installer® utility is required for installation, but it is not included
  119.   in  the  archive.   Get  it  from  somewhere  else  and  copy it to your C:
  120.   directory or somewhere where Workbench can find it.
  121.  
  122. * When I start python, I get "This program requires a math co-processor"!
  123.  
  124.   You have installed the wrong version. Pick the one with IEEE math.
  125.  
  126. * Python seems so slow!
  127.  
  128.   This  is  because Python is an interpreted language.  Some programs execute
  129.   slow because of this.  Other programs can run fast, because they are written
  130.   better, or make heavy use of the fast built-in (compiled) modules. Keep in
  131.   mind that function calls in Python have quite big overhead.
  132.  
  133. * I   get   "Couldn't   open   bsdsocket.library"   or   "Couldn't   open
  134.   usergroup.library" errors!
  135.  
  136.   You  are  trying to use functions that need one of these libraries.  AmiTCP
  137.   is required if you want to use all (network) functions.
  138.  
  139. * Python crashes when executing complex (recursive) code!
  140.  
  141.   This should not happen; you should get a MemoryError exception.  If it does
  142.   crash, increase your stack size and try again.  Python's default stack size
  143.   is 20K, which should be enough for most programs.
  144.  
  145. * Functions which use the PIPE: device (like os.popen) seem to work
  146.   incorrectly!
  147.  
  148.   The default l:queue-handler is buggy.  Make sure you have installed a fixed
  149.   l:queue-handler (I'm using util/sys/HWGQueue.lha from Aminet)
  150.  
  151. * Other errors
  152.  
  153.   Mail me at irmen@cs.vu.nl with a clear description of the problem.
  154.  
  155.  
  156. +----------------------+
  157. |                      |
  158. |  4. Future           |
  159. |                      |
  160. +----------------------+
  161.  
  162. A bunch of ideas which might be implemented someday in the future:
  163.    - interfaces to other Amiga libraries
  164.    - GUI module for building python apps with a GUI
  165.    - Support for other networking packages like I-Net
  166.    - Use Executive's API (sysinfo.library, if available) for process stuff?
  167.    - split python in several shared libraries
  168.    - bugfixes (are there any bugs? Let me know)
  169.  
  170.  
  171. +---------------+
  172. |               |
  173. |  5. History   |
  174. |               |
  175. +---------------+
  176.  
  177.  
  178. dec. 1995 to dec 1996: version 1.3 releases. History stripped.
  179. 1.3 is no longer supported.
  180.  
  181. 12 jan. 1997    - 1st public release of version 1.4
  182.           Some minor additional changes since 1.3.
  183.           Includes doslib & ARexx support.
  184.  
  185.  
  186.                     Irmen de Jong
  187.                     (irmen@cs.vu.nl)
  188.  
  189.